Download Sources and Javadocs with Maven

Peeking at the source code and documentation of different libraries and frameworks is a good way to learn more about them.

In this short tutorial, we’ll see how to configure Maven, or ask of Maven, to download the dependency sources and their Javadocs for us.

By default, Maven only downloads the actual JAR file of each dependency, not the sources and documentation files.

To download just the sources, first, we should navigate to the directory containing the pom.xml and then execute the command:

It may take a while to download the sources. Similarly, to download just the Javadocs, we can issue the command:

Of course, we can download both of them in one command, too:

Obviously, if we add a new dependency after issuing these commands, we have to re-issue the commands to download sources and Javadocs for the new dependency.

It’s also possible to download sources and documentation system-wide on all Maven projects. To do that, we should edit the ~/m2/settings.xml file or create one and add the following configuration to it:

As shown above, we’re creating a profile and activating it by default. In this profile, we’re setting two properties that tell Maven to download sources and documentation. Moreover, Maven will apply these settings to all projects.

It’s even possible to put this configuration into the pom.xml. This way, we force all project contributors to download sources and documentation as part of the dependency resolution:

Here, we’re configuring the maven-dependency-plugin to download the sources and documentation.

We can also set up our favorite IDEs to do this for us. For instance, in IntelliJ IDEA, we just have to go to Preference > Build, Execution, Deployment > Build Tools > Maven > importing and check the sources and documentation checkboxes:

In this quick tutorial, we saw how to download dependency sources and documentation in Maven in a variety of ways, ranging from command-line solutions to per-project or system-wide configurations.